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INTR0DUCTIOM 

Thisis the first in a series of newsletters intended to 
keep you informed of developments in APL\360 . 

The contents of the newsletters will generally include: 

* A detailed description of a system library 
workspace. 

* A section on hints for more efficient pro- 
gramming. 

* An APL puzzle. 

* New and interesting uses of APL. 

We look forward to contributions in all of these categories 
from the users of the system. 

API SYSTFM LIBRARY 

A system library will be set up, in common library 1, for 
workspaces of general interest. It will be the responsibility 
of the system librarian to see to it that workspaces proposed 
for this library meet reasonable standards of usefulness, freedom 
from error, and adequate documentation. 

It is desirable that library 1 be reserved exclusively for 
workspaces that have met the foregoing standards, and to this end 
it is requested that people who now have workspaces in this 
library move them to common library 10. 

,.. The Procedure for qualifying a workspace for the system 
library will be as follows: 
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A. Notify: 



Miss Colleen Conroy 

APL System Librarian 

IBM Corporation 

T. J. Watson Research Ctr. 

P. 0. Box 218 

Yorktown Heights, New York 10598 



and include, 



1. The library number and name of the workspace 
(in general, such workspaces should be retained 
In your private library). 

2. The names of three persons qualified to review 
the workspace. 

3. A summary of the workspace giving: 

a. Its general purpose. 

b. A list of functions with their syntax and 
intended usage. 

c. A list of significant global variables 
giving the functions in which they are used. 

d. If there is an i nterdependency among some 
functions this should be diagrammed or 
otherwise indicated. 

B. The librarian will save the workspace in a special 
review library and request selected reviewers to evaluate 
it, checking for bugs and adequacy of documentation. 

The reviewers' findings will be submitted to the 
author, as required, to improve the workspace and the 
documentation. 

C. When the workspace qualifies, it will be placed in 
library 1, and a copy of the documentation will be dis- 
tributed with the next following issue of the news- 
letter. 

It is hoped that many users will submit workspaces for 
inclusion in the system library, and in particular that workspaces 
currently in libraries 1 and 10 will be brought up to the fore- 
going standards. 
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This issue of the newsletter includes documentation for the 
following workspaces (all in library 1): 

CLEANSPACE 

NEWS 

UTILITY 

PROGRAMMING HINTS 

There are times when you wish to print a literal vector and 
simultaneously leave the function. This can be accomplished in 
one line as follows: 

-*0,p[>' LITERAL STRING MESSAGE 1 

The following two functions - called GUESS AND FOODFORTHOUGHT 
are examples of the uses of the representation symbol t - and 
the i-beam functions and how they can be used within functions. 

Unless you already know, perhaps you would like to analyze 
these two functions and determine precisely what they do. We'll 
give you the exact solution next time. 



They are: 



VR+FOODFORTHOUGBT 
[1] /?«-l + (6plO)Tl2 5 
[2] i?*-'/0123456789'[l + l 10 110 1 1\7?] 

V 

VR+X GUESS Y 
[1] i?«-(4aJ)/U,60 60 60)TI20 

V 



The Index origin in both cases is 1. 
APL PUZZLE 

Prove that, for positive integers. 



(Mx{N*M)=N+M\-N 



REMINDER : 



Please send all register dumps to L. M. Breed and R. H. 
Lathwell, who are located at the address on the letterhead. They 
would be interested in the following: 
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1. When you receive a register dump, which looks like 
this, 

0002001?'+ 6001D£42 00022794 00000028 00001794 
00001044 000017B8 00001808 00020000 4001Z?C;44 
FF550001 60000002 
SYSTEM ERROR 

only the first block of the register dump is needed 
along with the entire sequence of events from the 
last LOAD prior to the dump up to and including the 
first portion of the dump. 



******** 



If you have any other questions or comments, please feel free to 
call or write to Colleen Conroy at the address on the letterhead. 
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1 CLEANSPACE 



The workspace - CLEANSPACE - in Library 1 Is a clean space con- 
taining no functions or variables. It is used particularly in 
the following situations: 



3. 



If you are hunjr up in the execution of a 
function because of a quad input (□)/ type 
)L0AD 1 CLEANSPACE; the only way to get 
out of a quad prime (E)input, is by hanging 
up. 

To clear a workspace of superfluous functions, 
type )L0AD 1 CLEANSPACE. Then COPY any parti- 
cular variables, functions or entire workspaces 
des i red and SAVE. 

Copying of an entire workspace into a clnan 
workspace will sometimes increase the amount 
of usable workspace available since the COPY 
suppresses obsolete entries in the symbol table. 

To leave execution of functions, which may 
have been nested to a considerable depth, 
execute any of the following: )SAVE the work- 
space, )L0AD 1 CLEANSPACE, or )C0PY the work- 
space. 



INDEX ORIGIN: 1 
WIDTH: 129 

JULY, 1967 



APL\360 



C. A. Conroy, Ed. 



International Business Machines Corporation 



1 NEWS 



Thomas J. Watson Research Center 
P.O. Box 218 

Yorktown Heights, New York 10598 
91 4/WG 5-3000 



The main functions of this library workspace are: 

APLNOW 
APLOPS 
DESCRIBE 
SCHEDULE 

The following functions within this workspace are either used 
as subfunctions or In conjunction with the main functions. 
Because the main purpose of this workspace is to relay news, they 
will not be described in detail: 

CHSKD 

DATF 

PRINT 

TDATE 

TOD 

******** 



SYNTAX 

APLNOW B 



SUBFUNCTIONS; 
TDATE 
PRINT 



D ESCRIPTION 

The right argument B should consist of the 
following: MM,DD,YY where MM is the month, 
DD is the day, and YY is the year. For 
example, APLNOW 12,1,66. This function 
prints out all temporary notes and restric- 
tions on or after the date specified by the 
argument B. 



AT? LOP L 



Gives the latest current implementation 
status. APLOPS does not require any argu- 
ments for execution. 



DESCRIBE 



Gives a brief summary of the various func- 
tions within this workspace. 



SCHEDULE 



SUBFUNCTIONS: 
CHSKD 
DATF 



As the name implies, this function gives 
the APL system schedule information. This 
function does not require any arguments for 
execution. 



The following functions have been moved to Library 1 APLHIST: 

ALLSTATS 

HISTOGRAMS 

PLOTCUM 

INDEX ORIGIN: 1 
WIDTH: 129 
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SYNTAX 

R+ABCOS B 

SUBFUNCTIONt 
ARC SIN 

R+ARCSIN B 

R+-ARCTAN B 

R+COS B 

SUBFUNCTIONX 
SIN 

R+-COSH B 

R+DEG B 

DESCRIBE 

R+A LOG B 
R+RAD B 
R+SIN B 
R+SINH B 

R+-TAN B 

SUBFUNCTIONS: 
SIN, COS 

R+TANH B 



DESCRIPTION 
Inverse cosine of B in radians. 

Inverse sine of B in radians. 
Inverse tangent of B in radians. 
Cosine of B in radians. 

Hyperbolic cosine of B in radians. 

Conversion of B from radians to degrees. 

A brief description of the contents of 
this workspace. 

Base A logari thm of B. 

Conversion of B from degrees to radians. 

Sine of B in radians. 

Hyperbolic sine of B in radians. Large 
relative error possible for B close to 1. 

Tangent of B in radians. 



Hyperbolic tangent of B in radians. Large 
relative error possible for B close to 1." 



Except where noted, results have at least Ik correct decimal digits, 

In all of these functions, the arguments may be a scalar or arrays 
or any rank. The two arguments of the LOG function must be con- 
formable. That s, it is necessary that (pA)= P B or if their 
dimensions are different, one of them must be a scalar or an array 
containing only one element. 

INDEX ORIGIN: 1 
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